home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / misc / geoclock / geoglobe.doc < prev    next >
Text File  |  1994-03-18  |  4KB  |  82 lines
  1. 94/02/28   GeoGlobe version 1.4  Copyright 1994 GeoClock
  2.  
  3. GeoGlobe displays a smoothing revolving globe on a VGA screen.  It has
  4. a variety of parameters and options to make it an effective screen
  5. saver.
  6.  
  7. The program is started by entering  GEOGLOBE  at the DOS command line.
  8. It is stopped by pressing any key.
  9.  
  10. GeoGlobe runs best if you have at least 1.3 MB of free RAM (any combination
  11. of low RAM, EMS, and XMS).  If you do not have this much free memory,
  12. GeoGlobe will be forced to read some data from the disk on each revolution.
  13. If you have a large enough disk cache, this may be acceptable.  If the disk
  14. light comes on after several revolutions of the globe, you do not have
  15. enough memory to provide the best GeoGlobe performance.
  16.  
  17. The GGADJUST program will examine your system and recommend GeoGlobe
  18. command line settings.  If the globe does not rotate smoothly after a few
  19. revolutions, run to this program to find ways to smooth the rotation.
  20.  
  21. You might also want to experiment with P:
  22. GEOGLOBE  P
  23. causes GeoGlobe to preload all the globe data before the display starts,
  24. which eliminates the irregular display of the first rotation of the globe.
  25.  
  26.  
  27.  
  28. Here are all the options available on GeoGlobe:
  29. R  Do not load data into conventional RAM
  30. E  Do not load data into expanded (LIM) memory
  31. X  Do not load data into extended (HIMEM) memory
  32. P  Preload the globe data before starting display
  33. D  Always retrieve globe data from the disk
  34. W  Do not "walk" the globe
  35. All the above work WITHOUT a leading /
  36.  
  37. The following options require a leading / and usually need a parameter:
  38. /Dn     Wait n milliseconds between frame display.  This is the minimum
  39.      wait, and may be longer if the refresh rate of the monitor does not
  40.      divide n, or if it takes longer to read and process the frame.
  41. /Wfile  Read the walk data from named file (default is the internal
  42.      table give an eliptical walk)
  43. /Wyyyxxx  Show a fixed globe yyy pixels up from the lower right corner,
  44.      and xxx pixels left from the lower right corner.
  45. /Cxxbbgg  Use palette numbers (same as used in CSET) xx for background,
  46.      bb for blue (ocean) and gg for green (land).
  47. /L  -  does NOT display the sunlight curve
  48. /Lbbgg - displays the sunlight curve, using color bb for water in shade, and
  49.          gg for land in shade.  The sunlit colors are still set by /C
  50. /Kn - performs one walk step every n globe frames.  n=105 gives approximate
  51.       synchronization between the day and the year.  On a fast computer,
  52.       GEOGLOBE /K105 gives one complete revolution around the screen in
  53.       about 36.5 minutes, with each day taking about 6 seconds.
  54. /T - Show approximate date
  55. /X - Show rotation axis
  56. /B - starts the globe at a random position
  57. /Bmmdd - starts the globe at approximately date month mm, day dd.  The actual
  58.     starting point may be off by a day or two.
  59.  
  60.  
  61.   If you want to write your own "walk files" the format is:
  62.  
  63. Word 1 - number of walk points
  64. Word 2 - starting y (0 is lower right corner, max is 134)
  65. Word 3 - starting x (0 is lower right corner, max is 288)
  66. Array of "nibbles" (4 bit pieces, packed two per byte).  Each nibble is
  67. in the format yyxx (bits), which gives the change from the previous
  68. coordinate, plus two.  Thus if yy=11 (3), it corresponds to +1, while
  69. yy=01 (1), it corresponds to -1.  The number of bytes in this array
  70. should be half the number in Word 1, and word 1 must be even.
  71. Example:
  72. Word 1  10
  73. Word 2   20
  74. Word 3  30
  75. Byte 7  11101111 = 239 (dy=+1,dx=0;dy=+1,dx=+1)  (30,20)(30,21)(31,22)
  76. Byte 8  10111011 = 187 (dy=0,dx=+1;dy=0,dx=+1)   (31,22)(32,22)(33,22)
  77. Byte 9  01100110 = 102 (dy=-1,dx=0;dy=-1,dx=0)   (33,22)(33,21)(33,20)
  78. Byte 10 11010101 = 213 (dy=+1,dx=-1;dy=-1,dx=-1) (33,20)(32,21)(31,20)
  79. Byte 11 01011110 =  94 (dy=-1,dx=-1;dy=+1,dx=0)  (31,20)(30,19)(30,20)
  80.  
  81. Note that the system must end where it begins.
  82.